home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / hobby / gndemo.zip / MANUAL.DOC < prev    next >
Text File  |  1993-03-28  |  21KB  |  538 lines
  1.  
  2.  
  3.  GUN: GUN IDENTIFICATION SOFTWARE
  4.  
  5.  TABLE OF CONTENTS                                                   PAGE
  6.  
  7.  1. Disclaimer, Copyright, and Requirements  .......................   1
  8.  
  9.  2. Installation ...................................................   3
  10.  
  11.  3. Functions
  12.  
  13.    A. Gun Picture Libraries .......................................   4
  14.  
  15.    B. Parts  ......................................................   4
  16.  
  17.    C. Databases
  18.  
  19.      1. Gun .......................................................   5
  20.      2. Inventory .................................................   5
  21.      3. Dealers   .................................................   6
  22.      4. Trademark .................................................   6
  23.  
  24.    D. Serial Number Lookup ........................................   6
  25.  
  26.    E. Print .......................................................   6
  27.  
  28.    F. Help  .......................................................   6
  29.  
  30.    G. Picture Listings ............................................   7
  31.  
  32.  4. Pontification ..................................................  19
  33.  
  34.  5. Future Enhancements ............................................  20
  35.  
  36.  6. Support and Testing ............................................  20
  37.  
  38.  
  39.  
  40.  GUN -  Gun identification program
  41.  Published by Arren-San Software
  42.  P.O. Box 836393
  43.  Richardson, TX 75083-6393
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  @ Copyright 1993  Arren-San Software
  50.  
  51.  All rights reserved including the right of reproduction in whole or part
  52.  in any form. No part of this publication or the included software may be
  53.  reprodeced, transmitted, transcribed, stored in a retrieval system, or
  54.  translated into any language, or computer language, in any form, or by
  55.  any means electronic, mechanical, magnetic, optical, chemical, manual or
  56.  otherwise without prior written consent of Arren-San Software
  57.  
  58.  
  59.  Disclaimer
  60.  
  61.  Arren-San Software makes no representation or warranties with respect
  62.  to the contents hereof, and specifically disclaims any implied
  63.  warranties of merchantability or fitness for any particular purpose.
  64.  Arren-San Software disclaims any liability with respect to the purchaser
  65.  for the purchaser's actions based on information obtained from this
  66.  product. Further, the author shall not be liable even in the event of
  67.  notice of any defect in either the actual product or the data upon
  68.  which the product is based. Arren-San software reserves the right to
  69.  revise this publication, our software, or the data herein, and to make
  70.  changes from time to time in the context thereof, without obligation of
  71.  Arren-San Software to notify any person of such revisions or changes.
  72.  
  73.  
  74.   DO NOT PAY ANY SUM OF MONEY ($) BASED ON ANY INFORMATION GIVEN BY
  75.   THIS SOFTWARE. GUN DOES NOT DETERMINE VALUE, ONLY APPROXIMATE
  76.   CHARACTERISTICS OR PICTORIAL EXAMPLES FOR REFERENCE ONLY. ARREN-SAN
  77.   SOFTWARE HAS NOT MADE THIS PRODUCT AS A BASIS FOR PURCHASE OR
  78.   INVESTMENT DECISIONS.
  79.  
  80.   DO NOT MAKE ANY LEGAL DECISIONS BASED ON ANY STATUTE DOCUMENTATION 
  81.   INCLUDED IN THIS PACKAGE. ALWAYS CONSULT COMPETENT LEGAL AUTHORITIES
  82.   ON SUCH MATTERS.
  83.  
  84.   DO NOT USE THIS SOFTWARE AS A TECHNICAL GUIDE FOR OPERATING ANY 
  85.   WEAPON OF ANY KIND. DO NOT USE ANY TECHNICAL INFORMATION ABOUT ANY
  86.   RELOADING COMPONENTS AS A BASIS FOR RELOADING DECISIONS.
  87.  
  88.  Trademarks & Copyrights
  89.  
  90.  MS-DOS, Windows by Microsoft Corp.; PCX by ZSoft Corp; GIF by CompuServe
  91.  Incorporated ( H & R Block); LaserJet by Hewlett Packard, Inc. Ami Pro
  92.  by Lotus Croporation; Ventura Publisher by Xerox Corporation. GDS by
  93.  Phase II Electromics.
  94.  
  95.  REQUIREMENTS:
  96.  
  97.    GUN requires a DOS version 3.3 or higher and a VGA monitor / card,
  98.  with 640 x 480 resolution. The underpinning of any good picture
  99.  application is the viewer. The viewer chosen is GDS, and it is supplied
  100.  in zipped form. While the shareware version is being distributed, users
  101.  are encouraged to register the product.  The package is being
  102.  distributed with the express consent of Phase II Electronics and Bob
  103.  Holland. The choice to register will have no impact on this product. The
  104.  user will have to use PKunzip to unpack all shareware products
  105.  included for evaluation. The text editor, tde, is a public domain package,
  106.  and in keeping the spirit of such, it is also included in zip format. tde
  107.  includes the "C" source, and is used for all textual display functions in
  108.  addition to all editing functions. Thank you, Douglas Thompson (Australia)
  109.  and Frank Davis.
  110.  
  111.  
  112.  GUN - What is it and what it can do:
  113.  
  114.    GUN is a stand-alone firearms reference, including text, pictures, and
  115.  look-up tables for quick identification. This product currently has 37 GIF
  116.  and 20 PCX pictures / diagrams.  There is no limitation on the numbers of
  117.  pictures that can be stored or manipulated. The picture viewer, GDS, is
  118.  limited to 640 X 480 resolution. Please refer to the three GDS document
  119.  files under "Texts" for more about Graphics Display System.
  120.  
  121.   GUN has not been written to comply with Microsoft Windows, though GUN
  122.  has been tested in the Windows environment. A Windows version will be
  123.  available at a later date.
  124.  
  125.    The product is a command bar program, so simply select the desired
  126.  function and press <Enter>. To escape any command, simply hit escape.
  127.  The command bar reads as follows:
  128.  
  129.   PICTURES   DATABASES   SERIAL NUMBERS   TEXTS   PRINT   UTILITIES  HELP
  130.  
  131.  Each function is covered in detail below.
  132.  
  133.  
  134.  INSTALLATION
  135.  
  136.   Insert the disk marked installation and at the floppy drive prompt
  137.  type install. A screen will ask for the user to select the picture
  138.  libraries desired to be installed. Remember, any pictures can be deleted
  139.  at any time, or reinstalled, at the user's discretion. All system,
  140.  document, and otherwise required files will be automatically
  141.  installed. The required files take about 3 megabytes of hard disk
  142.  space. GUN cannot be run from a floppy only system. If the entire
  143.  product is chosen, the space requirement is about 5 Mb. The space
  144.  required is as follows:
  145.  
  146.  
  147.  System/Databases     2.8 mb
  148.  Pictures             1.4 mb
  149.  Knives                .4 mb
  150.  
  151.  
  152.    These amounts are approximate and subject to change, but the
  153.  install program will make sure the user's system has enough room
  154.  for all the selected data. The program can also be reinstalled at
  155.  any time. The installation program will not make any changes to any
  156.  other system file, such as AUTOEXEC.BAT or CONFIG.SYS.
  157.  
  158.  
  159.  
  160.  1.  GUNS
  161.  
  162.  This is the viewer module applied to each of the various picture
  163.  directories. Separate picture directories are mandatory as searching,
  164.  and retrieving picture files from a large file directory takes a long
  165.  time. For GDS navigation, please read the GDS documentation under
  166.  Texts. All pictures viewed by GUN use GDS. Please note the version used
  167.  here is UNREGISTERED, but GDS is being distributed in full accordance
  168.  with an agreement with Bob Holland and Phase II Electronics. All
  169.  pictures are *.GIF format unless noted. The directory structure is as
  170.  follows:
  171.  
  172.     GUN \ PICS   - Firearms
  173.     GUN \ PATS   - Patents 
  174.     GUN \ KNIVES - Fighting Knives
  175.  
  176.  See the detail picture listing starting on page 7.
  177.  
  178.  
  179.  Simply move the cursor with the Up / Down arrow keys to the desired
  180.  selection and press <Enter> or the left mouse button. The picture will
  181.  display, and stay displayed until <Enter> is pressed or the right mouse
  182.  button is pressed.
  183.  
  184.  
  185.  3.  DATABASES
  186.  
  187.  
  188.  A.  Gun Database
  189.  
  190.    The Gun database will allow the user to enter data about any
  191.  Gun or related instrument. Records can be inserted, deleted, edited,
  192.  etc. Once the record has been selected, the user can show a picture
  193.  tied to the Gun, find another record, browse the enitre database, or
  194.  quit the database. The database executable, ldm.exe, and the associated
  195.  db files are located in the \\gun\\db subdirectory (more later). The data
  196.  record has the following format:
  197.  
  198.       Manufacturer:
  199.       Address:
  200.       Type:
  201.       Model:
  202.       Year:
  203.       Top Value:
  204.       Mid Value:
  205.       Low Value:
  206.       Picture Path and Name:
  207.       Notes: (2 lines)
  208.  
  209.  
  210.  
  211.  NOTE:  NO VALUATIONS HAVE BEEN INCLUDED IN THIS SOFTWARE.
  212.  
  213.  
  214.  
  215.    The Gun database will be mostly filled with existing data and some 
  216.  pictures but pictures and or Gun records can be added, limited only by disk
  217.  space. When the user wants to add or delete pictures to view, simply
  218.  edit the "Pic" field. This is a living, breathing database. It will be as
  219.  good as the user makes it by providing the data desired.
  220.  
  221.    While in the existing database, another database can be requested,
  222.  while closing the current db. The commands can be accessed by moving the
  223.  arrow keys to the desired selection and pressing <Enter>. To exit the
  224.  database, simply choose Quit, or enter q <Enter> and y for yes at the
  225.  prompt. At any time, the database has Help by simply pressing F1. The
  226.  database one user keeps can be read and used by anyone using this
  227.  software. Utilities also exist to transform files into and out of *.dbf
  228.  format (dBase files).
  229.  
  230.  
  231.   The actual database functions are as follows:
  232.  
  233.   Use database     - the program brings you up in git
  234.   Use index        - default is manufacturer, model, year
  235.   Create database  - for new databases
  236.   Create index     - create a new order to sort data records_
  237.   Head             - first database record
  238.   Tail             - last database record
  239.   Browse           - search database forward from the current record
  240.   Next             - next record
  241.   Curr             - current record
  242.   Prev             - previous record
  243.   Find             - search by sort criteria
  244.   Add              - add a new record
  245.   Edit             - change an existing record
  246.   Delete           - delete an existing record
  247.   Show             - displays the picture file in the PIC field
  248.   Show field names - names of the fields in the database
  249.   Show index names - names of the different database indexes
  250.   Show index definition - shows how each index sorts the data
  251.   Quit
  252.  
  253.  
  254.  
  255.  B.  Inventory Database
  256.  
  257.  
  258.  This is the same database manager used for Gun. Sales, purchases,
  259.  and current inventory reports can be printed. This database will
  260.  collect, sort data, print reports and show pictures.
  261.  
  262.  
  263.  C.  Dealers Database
  264.  
  265.  
  266.  This function is a dealer database, partially complete with most known
  267.  Gun dealers. As with any of the databases, the data can be edited
  268.  directly by the user.
  269.  
  270.  
  271.  D.  Manufacturers Database
  272.  
  273.  
  274.  This function is a manufacturers database, partially complete with most
  275.  known gun manufacturers and distributors.
  276.  
  277.  
  278.  
  279.  4.  SERIAL NUMBER LOOKUP
  280.  
  281.  
  282.  The serial number lookup function will tell the user what year a Gun
  283.  is produced.  The manufacturers included are as follows:
  284.  
  285.  
  286.      Browning         gun \ lookup \ BrnXX.doc
  287.      Colt             gun \ lookup \ ColtXXX.doc
  288.      Luger            gun \ lookup \ Maubroom.doc
  289.      Parker Shotguns  gun \ lookup \ Parkshot.doc
  290.      Smith & Wesson   gun \ lookup \ SWXXX.doc
  291.      Winchester       gun \ lookup \ WinXXXX.doc
  292.  
  293.  
  294.  
  295.  If entering the actual serial number, chances are high that
  296.  they have been included. Serial prefixes are not required (nor used).
  297.  There is no cost-beneficial way to program exact year to serial number 
  298.  correlations for many manufacturers so discretion must be taken
  299.  with all of this feature. Due to cost / benefit restrictions, any number
  300.  input greater than the last actual production date defaults to the last
  301.  year of manufacture. 
  302.  
  303.  
  304.  DO NOT USE THIS FEATURE AS AN EXCLUSIVE MEANS TO DETERMINE ANY DATE OF
  305.  MANUFACTURE.
  306.  
  307.  
  308.   If the data is incorrect, simply edit the .doc file for that
  309.  manufacturer. It is the responsibility of the user to verify and update
  310.  the data. This is merely a data engine to process any data residing
  311.  in the document file. The data is stored in ascending order so some care
  312.  must be exercised. Each prefix category, where applicable MUST have a
  313.  last year, delimited by a serial number mgunimum value associated with
  314.  it. For example, a field XXXXX in length would list the final year of
  315.  production as having a serial number of 99999.  See win94.doc as an
  316.  example. Also see lookup help for instructions about editing lookup
  317.  data.
  318.  
  319.  
  320.  5.  TEXTS
  321.  
  322.  The texts included cover all the operating instructions for each program.
  323.  Please note this file is the operating instructions, so no printed manual
  324.  is required. However, if you need a hard copy, simply print this file,
  325.  \docs\manual.doc. Manuals are also included for the picture viewer and the
  326.  text editor. Also included are various documents about firearms statutes,
  327.  recalls, and the development / maintenance of the 2nd Amendment.
  328.  
  329.  
  330.  6.  PRINT  - Inventory reports 
  331.  
  332.  
  333.  The inventory module has print support for three types of reports about
  334.  the inventory database (invent.db) only and for the system defined
  335.  sort keys only. Current Inventory, Total Sales, and Total Purchases can
  336.  be generated from the print options menu. A report will include data
  337.  between input from and to dates, a name and address heading, if input,
  338.  and various sort options options. The output will be written to a file
  339.  if a file name is input, otherwise the report will be sent directly to
  340.  the printer. There is no current plan to add additional report formats
  341.  nor print for any additional databases.
  342.  
  343.  
  344.  7. HELP
  345.  
  346.  
  347.  All areas of this product have help support. Simply select the help menu
  348.  and the appropriate item within the help menu. The database, Gun Data
  349.  Manager has a unique help system invoked by pressing F1. All other help
  350.  must be selected from the main bar.
  351.  
  352.  
  353.  PICTURE LISTING
  354.  
  355.  
  356.  Total GIF (picture) files: 37     [ 36 at 320 x 200, 256 colors]
  357.                                    [  1 at 640 x 480, 256 colors]
  358.  Total PCX (B/W) files:      20    [All at ~370 x ~480, 2 colors]
  359.  
  360.  
  361.  GUNS  - 36 GIF files  and 1 library
  362.  
  363.  Pist01.GIF    High Standard High Sierra - Note octagonal barrel
  364.  Pist02.GIF    High Standard Derringer
  365.  Pist03.GIF    Smith & Wesson
  366.  Pist04.GIF    Ruger Blackhawk
  367.  Pist05.GIF    Smith & Wesson
  368.  Pist06.GIF    Smith & Wesson
  369.  Pist07.GIF    Browning Hi Power
  370.  Pist08.GIF    Browning Hi Power
  371.  Pist09.GIF    Browning Hi Power
  372.  Pist10.GIF    Walther P.38
  373.  Pist12.GIF    Walther P.38
  374.  Pist13.GIF    Smith & Wesson
  375.  Pist14.GIF    Ruger 22
  376.  Pist15.GIF
  377.  Pist16.GIF    Baby Auto Mag
  378.  Pist17.GIF    Browning Hi Power
  379.  Pist18.GIF    MAC-10
  380.  Pist19.GIF    MAC-10
  381.  Pist21.GIF    MAC-10
  382.  Pist22.GIF    MAC-10
  383.  Pist23.GIF    Luger
  384.  Pist24.GIF    Luger
  385.  Pist25.GIF    Smith & Wesson Single Action 6 Shooter
  386.  Pist26.GIF    High Standard Single Action 6 Shooter
  387.  Pist27.GIF    Colt Single Action 6 Shooter
  388.  Pist28.GIF    Harrington & Richardson Single Action 6 Shooter
  389.  Pist29.GIF    Harrington & Richardson Single Action 6 Shooter - closeup
  390.  Pist30.GIF    Whitney Wolverine - circa 1958
  391.  Pist31.GIF    Steyr GB
  392.  Pist34.GIF    Steyr GB - closeup
  393.  Rifl03.GIF    Winchester "Buffalo Bill" Commemorative
  394.  Shot01.GIF    Colt AR-15
  395.  Shot03.GIF    Ruger "Bull Pup"
  396.  Shot06.GIF    SPAS
  397.  
  398.  PATENTS - 20 PCX files
  399.  
  400.  Smitha.gif    Smith & Wesson 2,380,326 
  401.  Smithb.gif    Smith & Wesson 2,216,022 
  402.  Smithc.gif    Smith & Wesson 2,213,348 
  403.  Smithd.gif    Smith & Wesson 2,213,348 
  404.  Smithe.gif    Smith & Wesson 2,213,348 
  405.  Smithf.gif    Smith & Wesson 1,476,125 
  406.  Smithg.gif    Smith & Wesson 1,436,740 
  407.  Smithh.gif    Smith & Wesson 688,141   
  408.  Smithi.gif    Smith & Wesson 332,416   
  409.  Smithj.gif    Smith & Wesson 243,183   
  410.  Smithk.gif    Smith & Wesson 401,087   
  411.  Smithl.gif    Smith & Wesson 138,047   
  412.  Smithm.gif    Smith & Wesson 116225    
  413.  Smithn.gif    Smith & Wesson 114,374   
  414.  Smitho.gif    Smith & Wesson 78,847    
  415.  Smithp.gif    Smith & Wesson 72949     
  416.  Smithq.gif    Smith & Wesson 79434     
  417.  Smithr.gif    Smith & Wesson 12,648    
  418.  Smiths.gif    Smith & Wesson 10,535    
  419.  Smithz.gif    Smith & Wesson 20,627    
  420.  
  421.  
  422.  
  423.  Pontification - Ad Nauseum
  424.  
  425.  
  426.    Over the years, a growing community has become increasingly familiar
  427.  with "vintage" American firearms. Toward this end, a plethora of published
  428.  media has appeared in paper form extolling the virtues, and particulars of,
  429.  said firearms. In conjunction with my brother, Mikie, many firearms have
  430.  passed through our hands, and usually with no more tangible proof than a 
  431.  tattered Polaroid. Details such as color, condition, action, unique 
  432.  qualities, and what it looked like are by and large forgotten. With larger
  433.  dealers and collectors, I suspect this issue is more severe.
  434.  
  435.    I am probably naive in the belief that anyone still cares about the
  436.  guns, and not just the money. I cannot honestly tell you that I
  437.  do either. My intent is to provide a common platform for the consolidation
  438.  and distribution of gun knowlege.
  439.  
  440.    Books are a historical necessity, and text is immortal. But pictures
  441.  published in text are a fading commodity. Most gun texts do cover a
  442.  mountain of data, and this research must provide a basis on which to
  443.  move forward upon. However, the pictures usually black & white, or very
  444.  small. Further, printing large, color pictures is expensive for both the
  445.  publisher and the consumer. Until now, this was the best possible
  446.  solution.
  447.  
  448.    GUN is basically a picture application with no real upper limits. The
  449.  application currently has 37 full screen VGA, 256 color pictures
  450.  in varying resolutions. Picture qualities will only increase in
  451.  resolution and shrink in storage size.
  452.  
  453.    The guts of this idea is in Still Video computer images. This format
  454.  has many advantages over traditional photography, mainly that images can
  455.  be manipulated (larger, smaller, zoom, etc.), have an indefinite life,
  456.  can be transmitted electronically over telephone lines, and printed
  457.  through desktop publishing packages. There is no development costs to
  458.  generate the pictures, and the hardware is not prohibitively expensive.
  459.  
  460.  
  461.    The GIF images used in GUN are generated from a Still Video camera,
  462.  digitized in a high resolution format, usually 640 x 480 (rows and
  463.  columns) and 256 colors. The original files are between 150k and 250k
  464.  each.  At this rate a 900 picture application could take 150 to 225 mb
  465.  of hard disk space ( not to mention the 100-150 floppies to install it),
  466.  and most people simply do not have that much hard disk space. GUN
  467.  compresses these files into 320 X 200, 256 color which keeps about 85%
  468.  of the resolution in a 30k file. GUN allows that any portion of the
  469.  pictures can be used or deleted at any time to allow for ever changing
  470.  hard disk storage priorities of the user.
  471.  
  472.    Future versions may adopt different picture file formats to acheive
  473.  higher resolution with lower storage requirements. In the end, the user
  474.  / consumer must decide how much space to allocate to a Gun
  475.  identification software package. The objective of GUN is to fully define
  476.  vintage American Guns in an electric format through pictures and
  477.  text, while providing a platform for all users to share information.
  478.  
  479.  
  480.  
  481.  PLANNED ENHANCEMENTS:
  482.  
  483.    1. Efficient High Resolution pictures -  up to 1024 x 768 photo
  484.    2. Microsoft Windows version
  485.    3. Upgraded Dealer database
  486.    4. Complete knife module - database and pictures
  487.    5. Complete black powder module - database and pictures
  488.    6. Voice mail for software support
  489.    7. Bulletin board support for getting pictures, etc.
  490.    8. Publishing on a CD-ROM and / or tape back-up
  491.  
  492.  
  493.    OTHER CURRENT SERVICES:
  494.  
  495.             Manufacturers catalogs
  496.             Collection photography and cataloging
  497.             Inventory costing and analysis
  498.  
  499.  
  500.    TESTING: While testing has been performed on a variety of
  501.    DOS platforms, and printers, please forward any issues
  502.    encountered for the promptest attention.
  503.  
  504.  
  505.    SUPPORT: Leave a message, and you will be called back, but any
  506.    return call must be after CST business hours so leave an
  507.    evening number. We will endeavor to be fair about answering
  508.    any legitimate questions regarding this software and
  509.    addressing any product specific issues, but will not provide
  510.    general computer consulting as suport to this product.
  511.  
  512.    Other computing consultation or custom coding services are
  513.    available at competitive rates.
  514.  
  515.  
  516.     Written communication is preferred, so please write to:
  517.  
  518.     Arren-San Software
  519.     PO Box 836393
  520.     Richardson, Texas 75083-6393
  521.     Telephone: (214) 490-1908
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.               
  538.